CONNECTOR SGDE

Introducció

L'SGDE o Servei de Gestió del Document Electrònic ofereix una sèrie de serveis relacionats amb la gestió de documents electrònics. Aquests serveis els ofereixen les plataformes que integren l'SGDE. Actualment existeixen dues:

• Plataforma Adobe
• STD

Podeu trobar mes informació sobre els serveis i funcionalitats del SGDE aquí.

Propòsit

El propòsit del connector és proporcionar una API que pugui ser utilitzada de forma fàcil pels integradors d'aquest connector per consumir els diferents serveis del SGDE.

Context i Escenaris d'ús

El connector SGDE es troba dins els connectors funcionals de la Generalitat.

Versions i Dependències

En el present apartat es mostren quines són les versions i dependències necessàries per fer ús del Connector.

A qui va dirigit

Aquest document va dirigit als següents perfils:

1. Programador. Per conèixer l'ús del connector.
2. Arquitecte. Per conèixer quins són els components i la configuració del connector.

Descripció Detallada

Aquest connector ofereix els següents serveis:

Serveis Plataforma Adobe

• renderitzarFormulari: Servei per extreure dades d'un formulari.
• extreureDadesFormulari: Servei per extreure dades d'un formulari.
• convertirPdfaImatge: Servei per convertir un formulari a imatge.
• convertirPdfaPdfA: Servei per convertir un formulari a imatge.
• aplanarPDF: Servei per aplanar un pdf.
• signarPDF: Servei per a signar un pdf pla.

Serveis STD

• generarCSV: Servei per la generació d'un Codi Segur a partir d'un arxiu i una clau.
• composarPDFStream: Servei que composa un PDF a partir d'una plantilla i d'un document PDF enviat en Stream en la mateixa petició.
• composarPDFRemot: Servei que composa un PDF a partir d'una plantilla i d'un document PDF previament pujat al filesystem del STD.
• convertirPDF: Servei que converteix un document Ofimàtic (Word, Excel, PowerPoint, Imatges, OpenOffice,...) en PDF.
• convertirComposarPDF: Servei que converteix i posteriorment composa un arxiu ofimàtic.

Arquitectura i Components

Interfícies i Components Genèrics

Es pot trobar tota la documentació JavaDoc i el codi font referent aquests components a les següents url's:

Requeriments

El connector SGDE és compatible amb les versions 1.5 o superior de Java. Per versions inferiors no es garantit el seu correcte funcionament.

Instal.lació i Configuració

Instal.lació

La instal.lació del connector requereix de la utilització de la llibreria 'canigo-connectors-sgde' i les dependències indicades a l'apartat 'Introducció-Versions i Dependències'.

La instal?lació passa per modificar el pom.xml de l'aplicació per incloure les llibreries del Connector com a dependència.

<dependency>
    <groupId>canigo.connectors</groupId>
    <artifactId>canigo-connectors-sgde</artifactId>
    <version>1.1.0</version>
</dependency>

<dependency>
    <groupId>canigo.connectors</groupId>
	<artifactId>canigo-connectors-sgde-support</artifactId>
	<version>1.1.0</version>
</dependency>

IMPORTANT En el cas de que es vulgui integrar aquest connector en una aplicació que disposi del connector de la PICA, és farà necessari afegir les següents exclusions en aquests últim, per exemple el connector AVISALERT. <dependency> <groupId>canigo.connectors</groupId> <artifactId>canigo-connectors-pica</artifactId> <version>1.0</version> <exclusions> <exclusion> <groupId>xmlbeans</groupId> <artifactId>xbean</artifactId> </exclusion> <exclusion> <groupId>org.apache.axis2</groupId> <artifactId>axis2-jaxws</artifactId> </exclusion> <exclusion> <groupId>javax.xml.bind</groupId> <artifactId>jaxb-api</artifactId> </exclusion> <exclusion> <groupId>org.apache.woden</groupId> <artifactId>woden</artifactId> </exclusion> <exclusion> <groupId>org.apache.ws.commons.schema</groupId> <artifactId>XmlSchema</artifactId> </exclusion> </exclusions> </dependency> <dependency> <groupId>canigo.connectors</groupId> <artifactId>canigo-connectors-pica-avisosalertes</artifactId> <version>1.0.0</version> <exclusions> <exclusion> <groupId>org.apache.axis2</groupId> <artifactId>axis2-jaxws</artifactId> </exclusion> <exclusion> <groupId>org.apache.woden</groupId> <artifactId>woden</artifactId> </exclusion> <exclusion> <groupId>org.apache.ws.commons.schema</groupId> <artifactId>XmlSchema</artifactId> </exclusion> </exclusions> </dependency>

Configuració

1.- Per poder configurar el connector SGDE és necessari tindre definit el bean d'Spring següent en l'aplicació:

<bean id="sgdeConnector" class="net.gencat.ctti.canigo.connectors.canigo_connectors_sgde.impl.SGDEServiceImpl" init-method="setupService">
	<property name="loggingService" ref="loggingService"></property>
	<property name="formsWSDLUrl" value="http://eformularis.pre.intranet.gencat.cat/ServeisInvocacio/serveis/ServeisInvocacioV2?wsdl" />
	<property name="stdWSDLUrl" value="http://sgde.pre.intranet.gencat.cat/ServeisInvocacioSTD/services/ServeisSTDV2?wsdl" />
</bean>

NOTA: Les url's de l'exemple corresponen a l'entorn de PRE-producció.

Utilització del Connector

1.- Referenciar al servei SGDE des de l'acció que es vulgui utilitzar (action-servlet-aaa.xml):

<property name="sgdeService" ref="sgdeConnector"></property>

2.- En l'acció, s'hauran de crear els getters i setters corresponents per al connector de SGDE:

private ISGDEService sgdeService;
public ISGDEService getSgdeService() {
	return sgdeService;
}

public void setSgdeService(ISGDEService sgdeService) {
	this.sgdeService = sgdeService;
}

3.- Finalment fer la crida al servei en l'Action corresponent:

byte[] STD_ARXIU_PDF_TEST1 = IOUtils.toByteArray(Thread.currentThread().getContextClassLoader().getResourceAsStream("data_sgde/prueba_composar.pdf"));
ResultSTD result = sgdeService.generarCSV("ctti", "cscanigo", STD_ARXIU_PDF_TEST1, "cscanigo");

Per més informació sobre els diferents serveis que ofereix el SGDE consultar la documentació disponible aquí.